home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / MPW / gawk 2.11.1r3 / README.MPW < prev    next >
Encoding:
Text File  |  1991-06-08  |  2.6 KB  |  64 lines  |  [TEXT/MPS ]
  1. Gawk for the Mac (MPW)
  2.  
  3. This file documents the changes made to Gawk for the implementation
  4. as a Macintosh Programmer's Workshop tool. For general information,
  5. read the README and COPYING files.
  6.  
  7. Installing
  8.  
  9.  - Put the file "Gawk" into your MPW tools folder.
  10.  - Append the contents of the file "Gawk.Help" to your "MPW.Help" file
  11.  - Specifiy an appropriate AWKPATH, if necessary.
  12.  
  13. Modifying the source
  14.  
  15. To compile the source, you need MPW 3.0 or later and MPW C 3.0 or later.
  16. If you want to make changes to "awk.y", you also need bison or something
  17. equivalent.
  18.  
  19. User visible changes
  20.  
  21.  - Case insensitive comparisons work according to the Mac (8-bit) character
  22.    set, i.e. "ä" will match "Ä". (Well, what do you expect from a Swiss :-)
  23.  - The -m option has been added which tries to make regular expressions
  24.    work the MPW way.
  25.  - Lines are, of course, separated by CR and not by LF.
  26.  - Error messages for program files and data files come in an MPW executable
  27.    format. If you select an error message and execute it, the line where
  28.    the error occurred should pop up. This doesn't work for programs given
  29.    on the command line and for data given as standard input.
  30.  - A commando interface is provided. If you execute "Gawk…" or "Commando Gawk",
  31.    a dialog will let you specify all command line options.
  32.  - Because of the commando interface, the restriction that options appear
  33.    before input files has been dropped, which is also more consistent with
  34.    MPW behavior.
  35.  - A spinning cursor is shown, allowing MPW to run in the background while
  36.    gawk is running.
  37.  
  38. Limitations
  39.  
  40.  - MPW style patterns are a subset of what the MPW shell supports. The 
  41.    missing features are: variable substitutions like {XY}, repetition 
  42.    specifications like /[0-9]«5,8»/ and quoting with " or '.
  43.  - Pipelines and the system() call are not supported (maybe in System 7,
  44.    one day they will be :-).
  45.  - The code has become quite MPW tool specific. All changes to the code 
  46.    are bracketed by #ifdef/#ifndef macintosh directives. The folder unix.d 
  47.    contains several files that are not necessary or not supported on the 
  48.    Mac. On a UNIX system, move them to the "src" Folder. If you want to use 
  49.    gawk as a standalone Mac application, you will want to first check out 
  50.    the Think C port of gawk done by Tom Maszerowski <tcm@moscom.com>. 
  51.    
  52. Bugs
  53.  
  54. As I'm not very familiar with awk, I couldn't do much testing. Although
  55. I don't make any commitment to issue bug fixes, feel free to submit any
  56. problems you find with this version to me.
  57.  
  58. Matthias Neeracher
  59. Hohenklingenstrasse 19
  60. CH-8049 Zürich
  61. Switzerland
  62.  
  63. INTERNET: neeri@iis.ethz.ch
  64.